Skip to content

chore: improve skill descriptions, add trigger evals, bump to 1.1.1#19

Merged
keepithuman merged 6 commits intoitential:mainfrom
keepithuman:chore/skill-descriptions-evals
Apr 10, 2026
Merged

chore: improve skill descriptions, add trigger evals, bump to 1.1.1#19
keepithuman merged 6 commits intoitential:mainfrom
keepithuman:chore/skill-descriptions-evals

Conversation

@keepithuman
Copy link
Copy Markdown
Contributor

Summary

  • Skill descriptions rewritten for spec-agent, solution-arch-agent, builder-agent, explore, documentation, and project-to-spec — explicit trigger language, example phrases, and lifecycle handoff lines
  • documentation vs project-to-spec boundary clarifieddocumentation handles global/bulk catalog; project-to-spec handles named single projects; each redirects to the other
  • AGENTS.md — expanded silent re-auth procedure + project-scoped asset name gotcha (feat: improve builder-agent skill and helpers #24)
  • helpers/workflow-task-adapter.json — added adapter_id as top-level field
  • README/documentation example, Demo Specs section, version 1.1.1
  • Plugin version bumped to 1.1.1
  • Trigger evalsevals/trigger-evals/ with 20-query eval sets and results for 5 skills

🤖 Generated with Claude Code

keepithuman and others added 6 commits April 10, 2026 18:06
… 1.1.1

- Rewrites descriptions for spec-agent, solution-arch-agent, builder-agent,
  explore, documentation, and project-to-spec with explicit trigger language
  and "Trigger it for phrases like..." examples to reduce undertriggering
- Clarifies documentation vs project-to-spec boundary: documentation handles
  global/bulk catalog only; project-to-spec handles named single projects
- Adds documentation skill redirect to project-to-spec when a project is named
- Adds /documentation example to README How to Use It section
- Adds Demo Specs section to README with 4 demo spec links
- Bumps plugin version to 1.1.1
- Adds evals/trigger-evals/ with 20-query eval sets and results for 5 skills

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Replaces the one-liner "re-authenticate using .env" with a full
step-by-step procedure covering 401/403 detection, credential lookup,
OAuth vs local auth endpoint, .auth.json update, and request retry.
Based on post-session feedback that the existing guidance was insufficient.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Assets added to a project get an @{projectId}: prefix — PUT calls
without it return 400. Applies to any skill that reads or updates
project-owned assets, not just builder-agent.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
adapter_id is required in incoming variables for all adapter tasks —
missing it causes "No config found for Adapter" at runtime.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Adds lifecycle sequencing back to spec-agent, solution-arch-agent,
and builder-agent descriptions so Claude knows the correct order
and what each skill hands off to next.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@keepithuman keepithuman requested a review from a team as a code owner April 10, 2026 22:17
@keepithuman keepithuman merged commit 2e94b1a into itential:main Apr 10, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant